home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / games / 40 / applsoft / 8emulatr.doc < prev    next >
Text File  |  1987-01-19  |  4KB  |  107 lines
  1.  
  2.  Documentation for the Apple ][ A2.04 and Atari B1.01 versions of the
  3.  
  4.                     6502 EMULATOR ON THE ATARI ST
  5.                            Dec. 31, 1986
  6.  
  7.                          by Darek Mihocka
  8.  
  9.      The emulators work on any ST with a minimum of 512K, and works
  10. in any resolution, colour or monochrome.  It can be used as a tool to
  11. learn 6502 machine language, but also, it allows the ST to run Apple
  12. and Atari software.
  13.  
  14. Files in the 8BITEM.ARC file:
  15.  
  16.   - APPLE.TOS     (the Apple ][ emulator)
  17.   - ATARI.TOS     (the Atari 800 emulator)
  18.   - EMULATOR.DOC  (this file)
  19.   - CONVERT.C     (source code for a Apple to ST file conversion)
  20.   - DEMO.BIN      (a demo program in Basic for the Apple emulator)
  21.   - DEMOZP.BIN    (zero page locations to make DEMO work)
  22.  
  23.      It is up to the user to create files called APPLSOFT.BIN and
  24. INTBASIC.BIN by transfering the two languages over to the ST.  Both
  25. occupy memory locations $D000-$FFFF.
  26.  
  27.      It is up to the user to create file called OSB.BIN which is a
  28. binary file in DOS 2.0 format of the memory locations $A000-$FFFF.
  29.  
  30. DOS 2.0 format is $FF,$FF, start (lo), (hi), end (lo), (hi)
  31. followed by the actual binary data.
  32.  
  33.      The only software in the machine at load time is the monitor.
  34. It is similar to the monitor found on Commodore PETs and Apple
  35. ][s.  All commands are one character long, followed by any required
  36. parameters.  The following is a command summary with examples:
  37.  
  38.        : - change contents of memory
  39.                :12 34 56 puts 34 in 12 and 56 in 13
  40.  
  41.        B - boot virtual computer
  42.  
  43.        D - display memory
  44.                D 0000 0028 displays all memory from 00 to 28
  45.  
  46.        G - go to address
  47.                G 1234 starts executing at address 1234
  48.  
  49.        H - hardcopy control
  50.                H1 turns on printer output
  51.                H0 turns it off
  52.  
  53.        I - index of files on disk
  54.  
  55.        L - disassemble memory
  56.                L 3456 disassembles from 3456
  57.  
  58.        M - move memory block
  59.                M 4500 45FF 5600 moves 256 bytes from 4500 to 5600
  60.  
  61.        R - read binary file
  62.                R BASIC loads a file called BASIC into memory
  63.                format of file is $FF,$FF, start, end, data
  64.  
  65.        S - single step
  66.  
  67.        T - trace
  68.  
  69.        V - view video output screen
  70.  
  71.        W - write binary file
  72.                W 1200 19FF TESTFILE
  73.  
  74.        X - exit
  75.  
  76. A  more detailed command summary can be found in the  monitor  by
  77. pressing the HELP key.
  78.  
  79.      Using two modems, you can download the operating system from
  80. the Apple to the ST.  If you convert it into a Atari DOS 2.0
  81. compatible file, that is, a 6 byte header containing $FF,$FF, start
  82. address, end address, you can load it into the emulator with the R
  83. command.
  84.  
  85.      To transfer a program you load it into your Apple, and do a hex
  86. by modem to the ST.  What you must transfer is a dump generated by the
  87. Apple monitor and it must be in the format that appears on the screen
  88. normally.  You can modify the file CONVERT.C to change the format.  Then
  89. compile CONVERT.C to CONVERT.TTP and type in the file name to convert
  90. and the new filename ending in .BIN.
  91.  
  92.      To see a real demonstration of the emulator, load Applesoft
  93. Basic by typing "R APPLSOFT" and hit RETURN, then boot it by typing
  94. "B" and hit RETURN.  You will now be in an Apple ][ virtual computer.
  95. Type "CALL 768".  Then load a program, e.g. "R DEMO" and "R DEMOZP".
  96. Then type "B" and hit return.  The virtual computer should now have a
  97. demo program in memory.
  98. The editing, Basic, the machine language monitor, and even the
  99. graphics are similar.  Most public domain software can similarly be
  100. copied over a null cable, and will execute on the emulator.
  101.  
  102.      To exit, you must generate a software interrupt by executing
  103. a BRK instruction.  For example, typing "CALL 40000" will
  104. accomplish that.
  105.  
  106.  - Darek Mihocka     MegaBaud ST BBS (416) 243-9519